Page^Zrline 2, a^^i^ode 2604 in Figure';, de;d^^26D" and in^- - 26E - -; 
Page^2fUne 7, aftpr^2606 in Figure", deJ«i:e^'26E" and ips^rt - - 26F - -; 
Page pZTUne 16, a^ef^2608 in Figure", del^te^6F" and ins5rK^26G - -; 
Page 6^^f^e 16, a^€f^610 in Figure", dejgte^6G" and in^ - - 26H - -; 
PageJ^Xline 13, a^ef^'ViewListener" iijgeff - - (step 7516); 
Page l^^rline 14, a^6r"now to", dejpt^^igure 107" and in^^e^T^ Figures 107A- 
107C - -; 

Page^^P'^Tline 18, ^fter^shown in", dej@t6' "Figure 107" and ingeff^ Figures 107A- 

107C - 

Page 136,>ifielKdel^t€^igure 107" and ii^ert'^- Figures 107A-107C - -; 
Page 136,>ifie^after^;ki^ to", d^Jde'Tigure 108" andm^ert - - Figures 108A- 

108B - 

Page 13^flme 3, after "provided in", delete "Figure 108" and insert - - Figures 
108A-108B - -; 

Page 137, line n^^^ft^r^'illustrated in", d^«t€^igure 110" and in^eif^ Figures 



llOA-llOO--; 



PageJ37rline24, delpt^'^Tigure" and ips^rt — Figures - -; 
Page 137^JiB^5, del^t^OS" and insprf^08A-108B - -. 



IN THE DRAWINGS: 

Please approve the proposed amendment to the drawings as follows: 

9C has been split into Figures 9G^ET 
Figure I'fDhas been split into Figures 17I547E; 
Figure LTE'^ecame Figure 17F; 
Figure ITI^^became Figure IVCjT 
Figure ITQ-Became Figure 17H; 
Figure ITH-became Figure I7I;' 
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ApplicQtionMediotorlmpLexitn : AUS8- 1999-0694 
/*♦ 

^ LAi'v the Ap:,;icutionMediolor Dy exiling oil allocated ViewControlJe''s 

* and ApplicationMediotors. All dota is set to null, and lists ore 

* destroyed. An 'exited' ApplicotionMediotor cannot be used again. 

* If this method is overriden in a subclass, be sure to invoke 

* super.exitQ; 

public void exitQ | 

synchronized (this) \ 

/* Used for style 1 event dispatching. Leave this code comnnented. */ 
//if (this.eventThread !=null) j 

// eventThreod.stop (); 

// I catch (Exception e) | 

//{ 

/* Used for style 2 event dispatching. Leave this code connmented. */ 
for (int i = 0; i < runningThreods.sizeQ; i++) | 

((ApplicotionMediotorThread) runningThreods.elennentAt (i)) .stop(); 

runningThreods.removeAIIEIementsO; 
viewListeners.removeAIIEIements(); 

try I 

for (int i = 0; i < viewControilers.sizeQ; i++) { 

f(ViewController) viewControllers.elementAt(i)) .setEnabled(false); 
((ViewController) viewControllers.elennentAt(i)) .exit (); 

for (int i = 0; i < applicationMediators.size(); i++) | 

((ApplicationMediotor) applicationMediators.elementAt(i)) .setEnabled(false); 
((ApplicotionMediotor) applicationMediotors.elementAt(i)) .exitQ; 

I catch (Exception noProblem) | 

viewControllers = null; 
opplicotionMediators = null; 
runningThreods = null; 
runningThreods = null; 
data = null; 

{ 

^ FIG. 17F 
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/ 

ApolicotionMediotorlmpl.clenrQ : AUS8- 1999-0694 
/** 

♦ Clear the ApplicotionMeJiotor by cleoring ali oijucuied viewControllers " * ' * 

* ond ApplicotionMediators. All data is set to null, but lists ore 

♦ not destroyed. A 'cleored' ApplicotionMediotor con be used again. 
« If this nnethed is overriden in o subclass, be sure to invoke 

* super.cleorO; 

public void cleorQ j 

synchronized (this) j 

/♦ Used for style 1 event dispatching. Leave this code commented. */ 
//if (this.eventThreod != null) | 
// try{ 

// eventThreod.stop (); 

// I catch (Exception e) j 

//I 

/♦ Used for style 2 event dispatching. Leave this code commented. ♦/ 

for (int i = 0; i < runningThreads.size(); i++) | 

^ ((ApplicotionMediotorThread) runningThreods.elementAt (i)) .stopQ; 

runningThreads.removeAIIEIementsO; 

// 
try I 

for (int i = 0; i < viewControllers.sizeQ; i++) | 

ffViewController) viewControllers.elementAt(i)) .setEnabled(false); 
^ ((ViewController) viewControllers.elementAt(i)) .clear (); 

for (int i = 0; i < applicgtionMediators.size(); i++) { 

((ApplicotionMediotor) applicationMediators.elementAt(i)) .setEnabled(folse); 
^ ((ApplicotionMediotor) opplicotionMediators.elementAtO')) .clearQ; 

I catch (Exception noReoiProblem) | 

viewControllers = null; 
opplicotionMediators = null; 
doto = null; 
^ viewListeners.removeAIIEIementsQ; 

^ FIG. 17G 
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* Initalize the ApplicationMediotor using the listeners of on 

♦ existing ApplicationMediotor. 
*/ 

public void init(ApplicationMediQtor opplicationMediator) j 

if (opplicationMediator instonceol AppiicotionMediotorlmpl) \ 

ApplicotionMediotorimpI o = (AppiicotionMediotorlmpl) opplicotionMediotor; 
requestListeners = (Vector) a.requestListeners.clone(); 
plocementListeners = (Vector) a.plocennentListeners.clone(); 
topListeners = (Vector) o.topListeners.clone(); 
oddViewListener(Q); 



^ initO; 



FIG. 17H 
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* When new doto arrives allow the ViewControllers 

* and ApplicotionControllers to be refreshed also. 

«/ 

public void refresh (Object data) | 
this.doto = data; 
try I 

synchronized (viewControllers) | 

for (int j = 0; j < viewControllers.size(); j++) | 

((ViewController) viewControllers.elementAt(j)). 
refresh(dato); 

I catch (Exception noReolProblem) | 
try I 

synchronized (opplicationMediotors) | 

for (int j = 0; j < opplicotionMediotors.sizeO; j+f) j 
((ApplicationMediotor) opplicationMediotors. 
elementAt(j)).refresh(data); 

I catch (Exception noReolProblem) j 



FIG. 171 
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* A ViewEvent is delivered. Process it using Threading style 1 or 2. in 

♦ the end, the processViewEvent will be called on the subclass. 

V 

public void viewEventPerformed (ViewEvent e) } 

/♦ Used for style 2- cvera dispatching, start on inner doss thread ♦/ 
^ App!:cotionMer^!CtorThread t = new ApplicotionMediotorThreod (e); 
runningThreods.addElennent (t); 
t.stort (); 

/♦ Used for style 1 event dispatching. Leave this code connnnented. */ 

//ViewEvent saved = saveViewEvent(e); 

//if (eventThreod == null | | !eventThread.isAlive()) j 

// finished = false; 

// eventThreod = new Thread(this); 

// eventThread.stort (); 

//I 

//synchronized (this) | 
// nolifyO; 

I 

FIG. 17 J 
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This nnethod is used in style 1 threading. Renonne this to run {) 
♦ ond unconnnnent the code as described in the class jovadoc. 

*/ 

public final void run2 {) j 

/♦ Used for style 1 event dispotching. Leave this code connmented. */ 
/* 

while (true) j 

ViewEvent event = null; 
event = getViewEvent (); 
if (event != null) | 

hondleViewEvent (event); 
( else I 

woitForEvent (); 

if (finished) j 

// sonnething went wrong with the threod so hose this loop 
breok; 

( 



I 
j 

♦/ 



FIG. 17K 
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* Pnvate class to handle executions of ViewEvents () on another thread. 
*♦/ 

private class ApplicotionMediatorThreod extends Threod j 
/*♦ 

=^ The CL;..eni event 

**/ 

private ViewEvent event; 

/- 

* Create on ApplicotionMediatorThreod to process the ViewEvent 
**/ 

public ApplicationMediatorThread(ViewEvent event) | 
super (); 

this.event = event; 

* Just coll the handleViewEvent method that the subclass will override 
**/ 

public void run () | 

^ processViewEvenl (event); 

^ FIG. 17L 
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♦ Save the current ViewEvent on a Q 

y 

private final ViewEvent soveViewEvent (ViewEvent e) j 

/* Used for style 1 event dispatching. Leave this code commented. */ 
//return viewEventQueue.add(e); 
return null; 

I 



* Method: return the first view event saved. Used by the Q'ing system. 

V 

private ViewEvent getViewEvent () | 

/♦ Used for style 1 event dispatching. Leave this code commented. */ 
//return (ViewEvent) viewEventQueue.remove(); 
return null; 

} 

FIG. 1 7M 
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Tro nsDorter.reQuestEventPerformed(ReQuestEvent) :AUS8-1999-Q69,3 
/** 

Submit a synchronous request. For each Destination that is listening for 
the current family of RequestEvents (the major code), send the RequestEvent 
to the Destination for processing. If there is a problem, throw 
0 RequestException. Continue processing the RequestEvent as long 
as 0 RequestException is not thrown by o Destination and the RequestEvent 
is not consumed. 

If tagging is enabled, then oppend a status tag to the RequestEvent. • 
<P> 

Destinations are processed in the following FIFO order: 

1- All using (priority). 

2- All using a major code. 

3- All using 

<P> 

^©exception RequestException if the Request can't be submitted 

public void requestEventPerformed(RequestEvent request) throws RequestException } 
if ([enabled) | m / h k j 

^ throw new RequestExceptian("Transporter disabled"); 

/♦ Try to tag the request ♦/ v 
if (tagging) ^2606 
request.setStatus(request.getStatus() + "[Transporter]"); 

A Process PRIORITY, major and then WILDCARD destinations ♦/ 
processDestinationsf request. getDestinationsfPRIORITY)); 
processDestinationsfrequest, getDestinationsfrequest.getMajor())); 
processDestinations(request. getDestinations(wiLDCARD)); 



FIG. 26 F 



* Submit on osynchronous request. See the synchronous 

* requestEventPerformed for more information. 

public void requestEventPerformed(RequestEvent request, 
RequestResponseListener caller) throws RequestException j 
if (lenobied) | 

^ throw new RequestException("Transporter disabled"); 

if (tagging) 

request.setStatus(requesl.getStatus() + 

"[Transporter osync.]"); "*^2608 

//start on inner doss thread 

TransporterThread t = new TransporterThread(request. caller); 

runninqThreads,put(request, t); 

t.startO; 

FIG. 26G 
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TrQnsDorter.TrQnsDorterThreQd :ALIS8-1999-nfiq.^ 
/m 

♦ Prmh class to hcndle exec'^tons of submit*:;) or. another 
thread. 

private class TronsporterThreod extends Thread \ 
/** 

♦ The current request 

A* 

private RequestEvent request; 

A* 

♦ The caller of submit that we will coll back 

»/ 

private RequestResponseListener caller; 



A* 

* Creote a transporter thread 
**/ 

public TransporterThread(RequestEvent request. 
RequestResponseListener caller) | 
superQ; 

this.request = request; 
this.coller = caller; 

» Just call the synchronous version of 
requestEventPerfornnedO 
*V 

public void run() | 
try I 

requestEvenlPerformed(request); 

caller.requestResponse(request); 
j catch (RequestException yikes); | 

caller.requestException(yikes); 
I finally { 

runningThreods.rennove(request); 



FIG. 26 H 
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package com.ibm.jtcx.serialization; 

import java.io.Exlernciizable; 

import java.io.lOException; 

import java.io.Objectlnput; 

import jovo.io.ObjectOutput; 

A* 

* Default type comment. 

* <P>INVAR!ANT: 

V 

public class BaseData implements Externolizable j 
private Object[] data = null; 

A* 

* BaseData constructor comment. 

•/ 

public BoseDotaQ | 
this(O); 

A* 

* BaseData constructor comment. 

* @param dotoArray javaJang.Object[] 
♦/ 

public BaseData(int count) | 
super(); 

setDQtQ(new Object[count]); 

A* 

» Default method comment. 
» 

» <P>PRE: 

* <P>POST: 
* 

» ©return Parameter not modified 

* ©return java.lang.Object[] 
♦/ 

public final Object[], getDatoQ | 
return data; 

I 

FIG. 107 A 
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♦ Default method comment. 

♦ <'p>PRr. 

» <P>POST: 
« 

♦ ©return Parameter not modified 

♦ ©return jova.long.Object 

♦ ©param index int 

public final Object getData(int index) | 
Object retVal = null; 

if ({data != null) && (index < data.length)) | 
retVol = data[index]; 

I 

return retVal; 

I 

/- 

♦ Default method comment. 
» 

♦ <P>PRE: 

♦ <P>POST: 

« 

♦ ©return Porameter not modified 

♦ ©poram in Objectlnput 

public void readExternal(ObjectInput in) 

throws ClossNotFoundException, lOException | 

setDoto((Object[])in.reodObject()); 

/*» 

♦ Defoult method comment. 
* 

» <P>PRE: 

♦ <P>POST: 

♦ ©return Parameter not modified 

» ©param dotoArray java.lang.Object[] 

V 

public final void setData(Object[] dotoArray) | 
data = dotoArray; 

FIG. 107B 
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A* 

* Defoult method comment. 
* 

* <P>PRE: 

* <P>POST: 

* 

* ©return Parometer not modified 

* ©porom index int 

» ©porom dotoElement jovo. long. Object 

public final void setData(int index, object dotoElement) | 
if ((doto != null) Sc8c (index < doto.length)) | 
dotofindex] = dotoElement; 

* Defoult method comment. 
* 

* <P>PRE: 

* <P>POST: 

* 

* ©return Porometer not modified 

* ©porom out ObjectOutput 

public void wrileExternol(ObjectOutput out) throws lOException | 
out.writeObject(getDotQ()); 



FIG. 107C 
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package com. ibm.jtcx. serialization; 



ova.io.Externalizable; 

ava.io.lOException; 

ava.io.Objectlnput; 

avo.io.ObjectOutput; 

ava.moth.BigDecimal; 

ava.moth.Biglnteger; 

ava.utiLDate; 

ava.utiLEnumerotion; 

ava.util.GregorionCaiendar; 

ava.util.Hoshtable; 

ava.util.SimpleTimeZone; 

ava.util.TimeZone; 

ava.util.Vector; 



import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 

A* 

* Base class of data objects that require small serialization. The 

* attributes of the data object are stored in on array and the elements 

* of the array ore written individually. 
* 

* <P>1NVAR[ANT: 

public class BoseDaloS extends BoseDoto implements Externolizoble | 

A* 

* Default constructor. 

V 

public BoseDatoSO | 
superQ: 

A* 

* Creates o new <code>BaseDataS</code> object with a data array of 

* size <code>count</code>. 

* @param count the size of the data array containing the attributes 
*/ 

public BaseDatoS(int count) | 
super(count); 



FIG. 108A 
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A* 

♦ Reads the arroy of data elements from the stream. The responsibility 

♦ of reading the individual element is left to the 

♦ <code>BaseSerializer</code> via <code>readObjectQ<code>. 
« 

♦ @poram in the input stream thot contains the serialized object 

♦ ^exception ClossNotFoundException thrown if 

♦ <code>BaseSerializer</code> folic to read the object ^rom the stream 

♦ ©exception lOException thrown if 

♦ <code>BaseSerializer</code> foils to read the object from the streom 

♦ ©see BoseSeriolizerjifreadObject 
*/ 

public void readExternal(Objectlnput in) 

throws ClossNotFoundException, lOException | 

int size = in.readShort(); 

if (size == -1) I 

selDato(null); 

} else j 

Object[] arroy = new Object[size]; 

for (int i = 0; i < size; i++) | 

array[i] = BaseSerializer.getlnstance().readObject(in); 

setDoto(array); 

A* 

♦ Writes the array of data elements. The responsibility of writing the 

♦ doto elements is left to <code>BaseSeriatizer</code> via 

♦ <code>writeObject()</code>. 
♦ 

♦ ©porom out the output stream to which the data elements will be 

♦ written 

V 

public void writeExternal(ObjectOutput out) throws lOException | 
Object[] orroy = getData(); 

if (arroy == null) | 

out.writeShort(-l); 

I else I 

out.writeShort(orray.length); 

for (int i = 0; i < arroy.length; i++) | 

BaseSerializer.getlnstance().writeObject(out. array[i]); 

j ^ V 

10800 
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\ 

pockoge com.ibm.jtcx.seriolizotion; 



impor 
Imnor 

■ r 

impor 
impor 
impori 
impori 
imporl 
impori 
impori 
impori 



jova.io.*; 

ifivo.mcih.Biglnteger; 
jovo 
jovo 
javQ 
jovo 
jovo 
jovo 
jovo 
jovo 



.moth.BigDecimol; 
.util.Dote; 

.util.GregorionColendor; 
.utiliHoshtoble; 
.util.SimpleTimeZone; 
-utiLStringTokenizer; 
.utilJimeZone; 
.util.Vector; 



/ 



The <code>SerializerlF</code> that is used os the bose level 
seriolizer. It contains three tables used to serialize objects: 
<br><ul> 

<li> codeToble: the toble containing the seriolizotion code of 

on object based on the nome of the class 
<li> nomeToble: the table containing the name of the class 

based on the serialization code 
<li> seriolizotionTable: the table containing the seriolizer of 
on object based on its serialization code 

</ul> 
<br><br> 

<code>BoseSerializer</code> delegates the responsibility of 
seriolizing the objects to the <code>SeriQlizerlF</code> associated 
with that doss or to the object itself if it implements 
<code>Externalizable</code>. 

public class BoseSerializer implements SeriolizeriF | 
static private final int NULL_OBJECT = 0; 
static private final int OTHER = OxOOff; 

static private final String HASHTABLE_SER = "ClassNomeHosh.ser"; 
static private final String INLFILE = "ClassNames.ini"; 

static private Hoshtoble codeToble = null; 

static private Hoshtoble nomeToble = null; 

static private Hoshtoble seriolizerToble = null; 

static private BoseSerializer instance = null; 

class BigDecimolSeriolizer implements Seriolizer IF \ 

public Object readObject(Objectlnput in) throws ClossNotFoundException, lOException j 
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int scale = in.readShort(); 
int size = in.reodShortQ; 
byte[] bytes = new byte[size]; 
in.reodrully(bytes); 

Biglntege'r fennp = new Bic!!nteger(bytes); 
reluni new tiigOecimoi(temp, scole); 

public void writeObject{ObjectOutput out, Object elennent) throws lOException | 
BigDecimol bigD = (BigDecinnQl)elennent; 



class BiglntegerSeriolizer implennents SerioiizerlF { 

public Object reQdObject(Objectlnput in) throws ClossNotFoundException. lOException 

int size = in.reodShortO; 
byte[] bytes = new byte[size]; 
in.readFully(bytes); 

return new Biglnteger(bytes); 

public void writeObject(ObjectOutput out. Object elennent) throws lOException j 
byte[] bytes = ((Biglnteger)elennent).toByteArrGy(); 

out.writeShort(bytes.length); 
out.write(bytes); 



doss BooleonSeriolizer inripiements SerioiizerlF j 

public Object reQdObject(Objectlnput in) throws ClossNotFoundException, lOException 

int value = in.readByteQ; 

return (value == 1) ? Booleon.TRUE: Boolean.FALSE; 

public void writeObject(ObjectOutput out. Object elennent) throws lOException j 
out.writeByte(((Boolean)elennent).booleanValue() ? 1 : 0); 




out.writeShortfscole); 

out.writeShort(bytes.length); 

out.write(bytes); 
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doss RyteSerio!l7er implements SsrlolizerlF | 

public Object reodObject(0bjecllnpul in) throws ClossNotFoundExcspticn. lOExceplion | 
byte volue = in.reodByte(); 

^ return new Byte(volue): 

public void writeObject(ObjectOutput out, Object element) throws lOException j 
out.writeByte(({Byte)element).byteValue()); 

I ^ 

class CharacterSerializer implements SeriolizerlF | 

public Object readObject(Objectlnput in) throws ClossNotFoundException. lOException { 
char value = in.readCharQ; 

^ return new Character(value); 

public void writeObject(ObjectOutput out. Object element) throws lOException j 
out.writeChar(((Character)element).charValue()); 

I ^ 

doss DoteSeriolizer implements SeriolizerlF j 

public Object reodObjecl(Objectinput in) throws ClossNotFoundException lOException { 
long value = in.reodLongQ; 

^ return new Date(value); 

public void writeObject(ObjectOutput out, Object element) throws lOException \ 
out.writeLong(((Date)element).getTime()); 

j ^ 

doss OoubleSeriolizer implements SeriolizerlF | 

public Object reodObject{Objectlnput in) throws ClossNotFoundException, lOException j 
double volue = in.readDoubleQ: 

^ return new Double(volue); 

public void writeObject(ObjectOutpul out. Object element) throws lOException \ 
out.writeOouble(((Double)element).doubleValue()); 

I ^ 
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class RootSeriolizer implements SeriolizerlF j 

public Object readObject(0bjectlnput in) throws ClossNotFoundException. lOException | 
float volue = in.readFloatQ; 

return new Float(vaiue); 

public void writeObject(ObjectOutput out. Object element) throws lOException | 
out.writeFloot(((Floot)element).floatVolue()); 

class GregorianCalendorSerioiizer implements SeriolizerlF | 

public Object reodObject(Objectlnput in) throws CIcssNotFoundException. lOException } 
long time = in.readLongQ; 
Dote date = new Date(time); 
SeriolizerlF serializer = BaseSerializer.getlnstance(); 
TimeZone tz = (TimeZone)serializer.readObject(in); 

GregorionColender gColender = new GregorianCalendar(tz); 
gCalendar.setTime(date); 

return gCalendar; 

public void writeObject{ObjectOutput out. Object element) throws lOException | 
GregorionColendar temp = (GregorianCalendar)element; 

Dote dote = temp.getTimeQ; 
TimeZone tz = temp.getTimeZoneQ; 

out.writeLong(date.getTime()); 

SeriolizerlF seriolizer = BaseSeriolizer.getlnstance(); 

serializer.writeObject(out. tz); 

^ j 

class IntegerSeriolizer implements SeriolizerlF | 

public Object reQdObject(Objectlnput in) throws CIcssNotFoundException. lOException | 
int value = in.reodlntQ; 

return new Integer(value); 

public void writeObject(ObjectOutput out. Object element) throws lOException | 
out.writelnl(((lnteger)element).intValue()); 

^ I 

doss LongSeriolizer implements SeriolizerlF | 

public Object readObject(Objectlnput in) throws CIcssNotFoundException. lOException | 
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long value = in.readLongQ; 
return new Long(value); 



public void writeObject(ObjectOutput out, Object elennent) throws lOException j 
^ out.writeLong(((Long)elennent)JongValue()); 

class ObjectArroySerializer innplennents SeriolizerlF j 

public Object readObject(Objectlnput in) throws ClossNotFoundException. lOException | 
int size = in.reodShortQ; 

Objectf] orray = new Object[size]; 
for (int i = 0; i < size; i++) | 

SeriolizerlF seriolizer = BoseSeriolizer.getlnstanceQ; 
^ array[i] = serializer.readObject(in); 

return orroy; 

I 

public void writeObject(ObjectOulput out. Object elennent) throws lOException | 
Object[] orroy = (Object[])elennent; 

out.writeShort(array.length); 

for (int i = 0; i < orray length. i++) { 

SeriolizerlF seriolizer = BaseSerializer.getInstance(); 

serializer.writeObjecl(out, orray[i]; 



doss ObjectSeriotizer implennents SeriolizerlF } 

public Object readObject(Objectlnput in) throws ClossNotFoundException. lOException j 
return in.readObject(); 

I 

public void writeObject(ObjectOutput out, Object element) throws lOException { 



doss ShortSeriolizer implennents SeriolizerlF j 

public Object read0bject(0bjectlnput in) throws ClossNotFoundException. lOException j 
short value = in.reodShort(); 



out.writeObject(element); 



return new Short(value); 
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public void writeObject(ObjectOutpul out, Object element) throws iOException | 
out.writeShort(({Short)element).shortValue()); 

^ I 

doss SimpleTimeZoneSerializer implements SeriolizerIF \ ^ 

public Object reodObject(Objectlnput in) throws ClossNotFoundException, IOException { 
int offset = in.readlntQ; 

SeriolizerIF seriolizer = BoseSeriQlizer.getlnstonceQ; 
String id = (String)seriolizer.reodObject(in); 

return new SimpleTimeZone(offset, id); 

public void writeObject(ObjectOutput out, Object element) throws IOException \ 
SimpleTimeZone temp = (SimpleTimeZone)element; 

out.writelnt(temp.getRawOffset()); 

SeriolizerIF seriolizer = BaseSerializer.getlnstonce(); 

seriotizer.writeObject(out. temp.getlOQ); 

^ I 

class StringSeriolizer implements SeriolizerIF j , 

public Object reodObject{0bjectlnput in) throws ClossNotFoundException, IOException } 
int size = in.reodShortQ; 
byte[] bytes = new byte[size]; 
in.reodFully(bytes); 

return new String(bytes); 

public void writeObject(ObjectOutput out. Object element) throws IOException | 
byte[] bytes = ((String)element).getBytes(): 

out.writeShort(bytes.length); . . . . 
out.write(bytes); 

^ I 

doss VectorSeriolizer implements SeriolizerIF \ 

public Object readObject(0bjectlnput in) throws ClossNotFoundException. IOException } 
int size = in.readShort(); 

Vector vector = new Vector(size); 
for (int i = 0; i < size; i++) | 

SeriolizerIF seriolizer = BoseSeriolizer.getlnstonceQ; 

vector.addElement(seriolizer.reQdObject(in)); 

I 
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return vector; 

I 

public void v.riteObjcct{CbjectC^tpa; out, Objeci element) throws lOException j 
Vector temp = (Vector)element; 

Object[] array = new Object[temp.size()]; 
for (int i = 0; i < orroy.length; i++) j 
^ orroyfi] = temp.elementAt(i); 

out.writeShort(orroy.length); 

for (int i = 0; i < orroy.length; } 

SeriolizerIF seriolizer=BaseSeriolizer.getlnstance(); 
serializer.writeObject(oul, orroyfi]); 

* Defoult constructor. The constructor is private because this is a 

♦ singleton doss. When the object is constructed, it initiolizes its 

* tables. 

»/ 

private BaseSerializer() } 
^ initO: 

/*• 

* Adds the given elements to the three tables. 
* 

♦ ©porom clossNome the name of the class 
» ©parom code the code for the given class 

• ©porom serializer the object responsible for serializing the given 

♦ class 

V 

private void QddDataToTables{String clossNome. Number code. SeriolizerIF seriolizer) j 
getCodeTable().put(code. clossNome); 
getNameTable().put(classNome. code); 

if (seriolizer != null) j 

getSerializerToble().put(code. serializer); 

i 
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/" ... 

» Creates the codes and serializer objects for the defoult serialization 

♦ classes and adds them to the tobies. The tables ore then written to 

* 0 seriolized file. 

V 

private void createDefoultTobles() j 

0ddDotaToTables(8igDecimaLclass.getName(). new Byte((byte)1). new 
BigDecinnalSerializerO); 

addDQlQToTables(Biglnteger.class.getNQme(). new Byte((byte)2). new BiglntegerSeriolizerQ); 

oddDataToTablesfBooleon.class.getNameO. new Bvte((byte)3), new BooleanSerializer()); 

addDQtoToTables(Byte.clQSS.getNanne(). new Byte((byte)4). new ByteSerializerQ); 

addDQtaToTables{Character.class.getName(). new Byte((byte)5), new CharacterSerializer()); 

addDatoToTablesfOate.class.getNonneO, new Byte((byte)6j. new DateSerializerQ); 

oddDatQToTablesfDouble.class.getNameO. new Byte((byte)7), new DoubleSeriolizerQ); 

oddDolaToTablesfFloat.class.getNanneO, new Byte((byte)8). new FloatSeriolizerQ); 

addDataToTables(GreqorianCalendar.class.getName(). new Byte((byte)9). new 

GregorionColendarSeriolizerO; 

addDatoToTablesnnteger.class.getNameO. new Byte((byte)10), new IntegerSerializerQ); 

addDatoToTablesfLong.class.getNanneQ, new Byte((byte)1 1). new LongSerializerO); 

QddDotoToTablesjShort.class.getNQnneO, new Byte((byte)12), new ShortSeriolizer()); 

addDQtaToTables(SinnpleTinneZone.closs,getNanne(), new Byte((byte)13), new 
SinnpleTimeZoneSerializerQ); 

oddDataToToblesfString.class.getNameQ, new Byte((byte)14). new StringSeriolizerO); 

oddDataToTablesfVector.closs.gelNameQ. new Byteffbyte)15\ new VectorSeriolizerQ); 

addOataToTables(Object.clQSS.getNanneO. new Byte((byte)l6), new ObjectSeriolizer()); 

writeToblesO; 

♦ Returns an instance of the table of class names, keyed by their code. 
» If the toble does not exist, it is created. 

« 

* ©return The table of class names. 

♦/ 

protected Hoshtable getCodeTable() | 
if (codeTable == null) | 

codeTable = new Hashtoble(); 
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return codeToble; 

t Returns an 'nstancc of <code>BGseSeriaIizer</code>. 

♦ ©return An instance of <code>BoseSeriaiizer</code>. 

V 

public static SeriolizerlF getlnstanceQ \ 
if (instance == null) { 

instance = new BoseSerializerQ; 

I 

return instance; 

♦ Returns on instance of the table of codes, keyed by their 

♦ corresponding class nome. 

♦ If the table does not exist, it is created. 
♦ 

♦ ©return The table of codes. 

V 

protected Hoshtoble getNomeTableQ | 
if (nonneTabie == null) | 

nameToble = new HoshtobleQ; 

j 

return nameToble; 

♦ Returns on instance of the table of serializers. keyed by their 

♦ corresponding code. 

» If the toble does not exist, it is created. 
* 

♦ © return The table of class nonnes. 

protected Hoshtoble getSeriolizerTobleQ | 
if (seriolizerToble == null) | 

seriolizerToble = new HoshtobleQ; 

I 

return seriolizerTable; 

♦ Initializes the hoshtoble from either a serialized hoshtoble or from 
« on ini file. 
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protected void init() | 

File sericlizedFile = new File(HASHTABLE_SER); 
File iniFile = new File(INi_FILE); 

if (seriolizedFiie.existsQ) | 

readSeriolizedFile(serializedFile); 

j else j 

if (iniFile.existsQ) | 

readlniFile(iniFile); 

( 

creoteDefaultTabiesQ; 

A* 

♦ Gets the value of the serialization code from the table based on 

♦ the clossNonne provided. The value returned con either be a 

♦ <code>Byte</code> or an <code>Integer</code>. The return volue 

♦ will be a <code>Byte</code> if the clossNonne is one of the base 

♦ data types. 
* 

» ©return The serialization code of the clossName. 

♦ @param clossName the name of the class 

V 

private Number lookupCode(String clossName) { 
Number code = null; 

if (clossName != null) { 

code = (Number)getNameTable().get(className); 

return code; 

I 

/- 

♦ Looks up the hashcode in the table and returns the String value of 

♦ the hashcode. If the hashcode does not exist in the table 

♦ <code>null</code> is returned. 

©return The object that was stored in the table with the given 

♦ hashcode. 

» ©parom hashcode the hashcode that will be used to look up the value 
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\ 

private String lookupNQnne(Number code) | 
String clossNonne = null; 

ir (code != null) \ 

^ clossNonne = (String)getCodeToble().get(code); 



return clossNonne; 



♦ Defoult nnethod connnnent. 
* 

» <P>PRE: 

♦ <P>POST: 

* 

♦ ©return Poronneter not modified 

♦ ©return com.ibm.jtc.util.SeriolizerIF 

♦ ©porom code int 

V 

private SerializerIF lookupSerializer(Number code) | 
SeriolizerlF seriolizer = null; 



if (code != null) | 

^ seriolizer = (SerializerlF)getSerializerTable().get(code); 
return seriolizer; 



♦ Defoult method comment. 

♦ <P>PRE: 

♦ <P>POST: 

♦ ©return Parameter not modified 

♦ ©porom iniFile jova.io.File 

*/ 

privote void readlniFile(File iniFile) j 
BufferedReoder in = null; 

try j 

in = new BufferedReader(new FileReoder((niFile)); 

for (String inline = in.reodLine(); inline != null; inline = in.readline()) | 
String trimline = inLine.trim(); 
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if ((trimLine.lengthQ > 0) && 

!trimLine.startsWith("r)) I 
- StrinyTokenizer tokenizer = new StringTcken;2er(tr;rr.uine); 

String classNome = lokenizer.nextTokenQ; 

Integer code = new lnteger(clQSsNQme.hQshCode()); 

SerializerIF seriolizer = null; 

if (tokenizer.hasMoreTokensQ) \ 

String seriolizerNome = tokenizer.nextToken(); 

try I 

seriolizer = (SeriQlizerlF)Class.forName(seriQlizerNome).newInstonce(); 
^ I catch(Exception e) | \ 

oddDQtoToTables(clQSsNonne. code, seriolizer); 



writeToblesQ; 

A* 

* Reods the object from the streonn by first reading the code for the 
« elennent then reods the appropriate data for thot object. 



♦ ©return The object that wos read fronn the stream. 

♦ ©porom in the input stream that contains the object 

V 

public Object readObject(Objectlnput in) 

throws ClossNotFoundException, lOException | 
Object retVal = null; 
Number code = null; 

byte boseCode = in.reodByteQ; 



catch f Exception throwAwoy) \ 
finally 
try i 

in.closeQ; 
I catch (Exception throwAwoy) | 



♦ 
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if (boseCode NULLOBJECT) | 
relVol = null; 

I else I 

If (uObeCude != OfHLR) J 

code = new Byte(baseCode); 

I else \ 

int secondCode = in.readlnt(); 
code = new Integer(secondCode); 



SerializerIF seriolizer = lookupSerializer(code); 
if (seriolizer != null) | 

retVol = seriQlizer.readObject(in); 

I else I 

String clossNonne = lookupName(code); 
t7 I 

retVol = Closs.forName(classNanne).newlnstonce(); 

if (retVol instonceof Externolizoble) j 

((ExternolizQble)retVol).readExternol(in); • 

I else I 

retVol = in.reodObjectO; 
I cotch(Exception e) | 



return retVol; 



* Reods the file contoining the serialized hoshtobles of doto. 

* ©poronn seriolizedFile the file contoining the seriolized tobies 

V 

privote void reodSeriolizedFile(File seriolizedFile) j 
ObjectlnputStreonn in = null; 
try j 

in = new ObjectlnputStreonn(new FilelnputStreom(serializedFile)); 
codeToble = (Hoshtoble)in.reodObiect(); 
nomeToble = (Hoshtoble)in.reodObject(); 
seriolizerToble = (Hoshtoble)in.reodObject(); 
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\ 

catch fException throwAwoy) j 
finally \ 

in.dose(); 
I catch (Exception throwAwoy) | \ 

if ((codeTable == null) || 

(nameTobie == null) || 
(serializerToble == null)) | 



i 



creoteDefouitToblesO; 



I 

A* 

* Writes the given object to the streonn. First, the code representing 

* the type of the object is written, then the data within the object 

* is written, 
* 

* @param out the output stream that will contain the object 

* ©param element the data object that will be written 

»/ 

public void writeObject(ObjectOutput out, Object element) 
throws lOException | 

if (element == null) j 

out.writeByte(NULL_OBJECT); 

j else I 

String clossNome = element.getClass().getName(); 
Number code = lookupCode(className); 

if (code != null) \ 

if (code instonceof Byte) j 

out.writeByte(code.byteValue()); 
( else if (code instonceof Integer) | 
out.writeByte(OTHER); 
out.writeInt(code.intValue()); 

SerializerIF seriolizer = lookupSerializer(code); 

if (seriolizer != null) j 

serializer.wrileObject(out. element); 
j else if (element instonceof Externalizoble) j 

((Externalizable)element).writeExternal(out); 
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I else I 

out.writeObjectfelernent): 

J 

{ else I 

if (element instonceof Objectf]) \ 

classNome = Object[].class.getName(); 

( else I 

classNome = Objecl.clQSS.qetName(); 

I 

code = lookupCode(className); 

SeriolizerlF seriolizer = lookupSeriQlizer(code); 

out.writeByte(code.byteVolue()); 
seriQlizer.writeObject(out, element); 



* Writes the tables to the file. 

private void writeTobles() } 

ObjectOutputStreom out = null; 

try I 

File serRle = new File(HASHTABLE_SER); 

out = new ObjectOutputStream(new FileOutputStream(serFile)); 

out.writeObject{getCodeTable()); 
out.writeObjectfgetNameTableQ); 
out.writeObject(getSeriolizerToble{)); 
out.writeObject(new DoteQ); 
catch(Exception e) | 
finally | 
try I 

out.closeQ; 
j catch(Exception e) | { 
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